Метод IServices::GetSingleItemByUSI

Возвращает ссылку на объект сервиса по его USI.

IDL

[id(103508)]
HRESULT GetSingleItemByUSI(
    [in] BSTR ServiceUSI, 
    [out, retval] IService** Value
);

Параметры

Параметры	Описание
ServiceUSI	USI сервиса
Value	Возвращаемое значение

Возвращаемое значение

Ссылка на объект сервиса.

Описание

Метод выполняет поиск экземпляра сервиса с указанным USI среди закэшированных сервисов, созданных методами IServices::GetSingleItemByID или IServices::GetSingleItemByUSI.

Если сервис найден, то метод возвращает ссылку на найденный экземпляр сервиса.

Если сервис не найден, то метод создает экземпляр сервиса, кэширует его и возвращает на него ссылку.

Метод возвращает ссылку на объект сервиса с указанным USI.

Примечания

№	Описание
1.	Допускается передавать в параметре значение кода сервиса вместо полного USI.

Требования

№	Описание
1.	Сервис c указанным USI должен существовать.

Смотрите также

IServices::GetSingleItemByID